package com.huangyi.adminservice.map.service;

import com.huangyi.adminapi.map.domain.dto.LocationReqDTO;
import com.huangyi.adminapi.map.domain.dto.PlaceSearchReqDTO;
import com.huangyi.adminapi.map.domain.vo.SearchPoiVo;
import com.huangyi.adminservice.map.domain.dto.RegionCityDTO;
import com.huangyi.adminservice.map.domain.dto.SearchPoiDTO;
import com.huangyi.adminservice.map.domain.dto.SysRegionDTO;
import com.huangyi.commoncore.domain.dto.BasePageDTO;
import com.huangyi.commondomain.domain.R;
import com.huangyi.commondomain.domain.vo.BasePageVO;

import java.util.List;
import java.util.Map;

/**
 * 地图服务层的接口
 */
public interface IMapService {

    /**
     * 城市列表查询
     * @return 城市列表信息
     */
    List<SysRegionDTO> getCityList();

    /**
     * 拼音归类的城市查询
     *
     * @return 城市字母与城市列表的MAP
     */
    Map<String, List<SysRegionDTO>> getCityPyList();

    /**
     * 根据父级区域ID获取子级区域列表
     * @param parentId 父级区域ID
     * @return 子级区域列表
     */
    List<SysRegionDTO> getRegionChildren(Long parentId);


    /**
     * 获取热门城市列表
     * @return 返回热门城市列表
     */
    List<SysRegionDTO> getCityHostList();

    /**
     * 根据地点(id + keyword)搜索
     * @param placeSearchReqDTO 搜索条件
     * @return 搜索结果
     */
    BasePageDTO<SearchPoiDTO> searchSuggestOnMap(PlaceSearchReqDTO placeSearchReqDTO);


    /**
     * 根据经纬度来定位城市
     * @param locationReqDTO 经纬度信息
     * @return 城市信息
     */
    RegionCityDTO getCityByLocation(LocationReqDTO locationReqDTO);
}
